home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 1 Issue 2 / PDCD-1 - Issue 02.iso / _utilities / utilities / 001 / qzapsrc / !QZap_!Help < prev    next >
Encoding:
Text File  |  1994-11-11  |  5.3 KB  |  110 lines
  1. !QZap 0.20  November 1994
  2. =========================
  3.  
  4. #include <std/disclaimer.h>
  5. QZap is copyright ⌐ 1994 Kevin F. Quinn.  It is distributed in good
  6. faith, but without any warranty, even without any implied warranty of
  7. merchantability or fitness for a particular purpose.
  8.  
  9. QZap 0.20 is free.  No charge may be made for the software itself,
  10. however reasonable charges may be made to cover handling, distribution
  11. and media costs.
  12.  
  13. Source code is available.
  14.  
  15. Comments, suggestions and bug reports to qzap@banana.demon.co.uk.
  16.  
  17. --------------------------------------------------------------------------
  18.  
  19. Introduction
  20. ============
  21.  
  22.    QZap is a simple disassembler for the Risc OS Wimp environment.
  23. It displays code disassembly in scrolling windows.  It provides
  24. facilities to write the disassembly to a file, in various formats. 
  25. The most useful feature is that it only uses up 64K of memory.  It
  26. disassembles from disk, and doesn't attempt to load the file in
  27. question into RAM.  It never needs any more RAM - all memory
  28. allocation is static.  It should also run under Risc OS 2.0.  This
  29. is a simple application and as such does not need anything offered
  30. by Risc OS 3 that is not available under Risc OS 2.0.
  31.  
  32. Instructions for use
  33. ====================
  34.  
  35.   1) To launch !QZap, double-click on the QZap icon in the filer window.
  36.      An icon should appear on the icon bar, showing a spanner and a
  37.      screwdriver.  This is the QZap icon.
  38.  
  39.   2) To disassemble a file, drag it from a filer window onto the QZap
  40.      icon.  A disassembly window should open.
  41.  
  42.   3) Click SELECT (left mouse button) on the icon bar to open another
  43.      disassembly window - currently up to 16 may be open at one time.
  44.      Once a file has been dragged to the QZap icon, even if all the
  45.      disassembly windows are closed, the application remembers which
  46.      file was dragged and will still open a new window when SELECT
  47.      is clicked on the QZap icon.
  48.  
  49.   4) In the main viewer window, use the drag bars as normal to scroll
  50.      around the disassembly.
  51.  
  52.   5) If a double-click SELECT is made on an instruction with a suitable
  53.      address in it (e.g. BL &8064) then a new window will be opened,
  54.      showing that address at the top.
  55.  
  56.   6) Clicking MENU in a viewer window will bring up the viewer menu.
  57.      This consists of several items as follows:
  58.      
  59.        Save           Leads to the save window (see below)
  60.        Select         Has a submenu which leads to:
  61.          Start        Leads to a writeable menu entry in which the start
  62.                         address of the selection can be entered.
  63.          End          Leads to a writeable menu entry in which the end
  64.                         address of the selection can be entered.
  65.          Save         Leads to the save window (see below)
  66.        Goto line      Leads to a writeable menu entry in which an address
  67.                         may be entered, at which point the viewer window
  68.                         will move to the address entered.
  69.        New view       Leads to a writeable menu entry in which an address
  70.                         may be entered, at which point a new viewer will
  71.                         be opened at the address entered.
  72.        Set base       Leads to a writeable menu entry in which an address
  73.                         may be entered, at which point all viewers will be
  74.                         redrawn using the entered address as the base load
  75.                         address of the file.
  76.        Display        Has a submenu which leads to:
  77.          Invert       Swaps the foreground and background in all windows.
  78.          Foreground   Leads to a colour selection menu, which is used to
  79.                         change the colour of the foreground writing in the
  80.                         viewer window (also the background colour for
  81.                         the selected area).
  82.          Background   Leads to a colour selection menu, which is used to
  83.                         change the colour of the background writing in the
  84.                         viewer window (also the foreground colour for
  85.                         the selected area).
  86.        Quit           Quits the application.
  87.  
  88.   7) The save window is brought up in two ways.  The first is from the
  89.      first item in the viewer window, and the second is from the save
  90.      option in the "Selection" submenu.  Both perform very similarly to
  91.      each other, the only difference being that the Selection->save
  92.      only saves the portion of the disassembly currently selected,
  93.      whereas the other will save the whole file.
  94.  
  95.      By clicking on the boxes on the left of the save window, the order
  96.      in which the parts of disassembled instructions are written can be
  97.      set.  The numbers on the right indicate the current order.
  98.      
  99.      To save the disassembly, either a full file and pathname can be
  100.      entered into the writeable icon, or just the file leafname may be
  101.      entered and the text icon dragged to a filer window.
  102.      
  103.   8) There is a file inside the !QZap directory called "Addresses".
  104.      This defines the start address that is assumed for various file
  105.      types.  The pseudo-filetype "default" defines the start address
  106.      for any filetypes not listed in the file.  Any lines starting
  107.      with "|" are considered to be comments, and are ignored.
  108.      Any file that does not have a filetype will be loaded using the
  109.      load address of the file.
  110.